home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / terms / kermit / b / ikrker.bwr < prev    next >
Encoding:
Text File  |  1992-12-06  |  9.4 KB  |  189 lines
  1. ROSCOE Kermit 4.2.x "Beware File" - Known Bugs, Problems, Limitations.
  2.  
  3. As of: 8:12pm  Friday, 1992 January 10
  4.  
  5. In order to install ROSCOE Kermit, it is first necessary to have all the
  6. materials for TSO Kermit, specifically, the files with prefixes of IKT
  7. and IK0 (I K zero).  This file (IKRKER.BWR) and its companion file
  8. IKRKER.UPD are supplements to the corresponding TSO Kermit files
  9. IKTKER.BWR and IKTKER.UPD.  Thus, ROSCOE Kermit is just a variant of TSO
  10. Kermit (for the present, anyway) with a few extra updates to take care
  11. of special problems in the ROSCOE/ETSO environment.  In particular, it
  12. still uses "Kermit-TSO>" as the prompt and announces itself to other
  13. Kermits as "TSO" (via the attribute mechanism, but this is about to
  14. change).  At some time in the future, there will be more extensive
  15. updates which take advantage of the features of ROSCOE, and users are
  16. encouraged to consider adding support for ROSCOE-specific files.  ROSCOE
  17. Kermit has been reported to work successfully under both V5.6 and V5.7
  18. of ROSCOE, but no reports have specifically mentioned any other
  19. versions.
  20.  
  21. For the uninitiate, here is a brief description of ROSCOE:
  22.  
  23.  ROSCOE is a TSO substitute created around 1980 and now marketed by CA.
  24.  It is a multi-user address space with editing and job-submitting
  25.  facilities and a CLIST-like language called RPF (ROSCOE Programming
  26.  Facility).  One of the components of ROSCOE is the Extended Time Share
  27.  Option (ETSO), which allows many programs written for TSO environments
  28.  to function under ROSCOE.  However, there are often problems, due
  29.  mainly to the fact that everyone is in the same address space.  This
  30.  can cause memory to run short or applications not to work at all.  The
  31.  best thing about ROSCOE is its file structure, which compresses data
  32.  automatically and keeps DASD VTOC's from getting cluttered.  Each user
  33.  is allotted a certain amount of space and is assigned a library prefix
  34.  for the members he or she creates.  Files for all users are stored in
  35.  (typically) 5 datasets located on different packs.
  36.  
  37. This file contains (A) instructions for applying Kermit updates, (B) a
  38. list of unresolved problems, (C) a list of problems with work-arounds or
  39. optional fixes, and (D) a list of resolved problems.
  40.  
  41. NOTE: entries will sometimes be entered under (D) even though the needed
  42. updates have not been released in IKRKER.UPD.  Please check the date of
  43. the UPD file to see if it has been changed before requesting a new copy.
  44.  
  45. Bug reports should be sent to John Chandler <JCHBN@CUVMB.CC.COLUMBIA.EDU>.
  46. Some of the reports received to date have been included more-or-less
  47. verbatim in parts (A)-(D) below and have been designated with the
  48. initials of the correspondent: SC = Stuart Campbell, JL = John Lundberg,
  49. DS = Dave Saunders.  Dave Saunders also provided the summary of ROSCOE
  50. above.
  51.  
  52. Kermit-370 carries an "edit" number in addition to the version and
  53. release numbers.  The three numbers together are printed out in the
  54. assembly listing and displayed by Kermit at startup time.  Be sure to
  55. include all three numbers (e.g., 4.2.1) along with any error reports.
  56.  
  57. A) Update instructions .................................................
  58.  
  59. Refer to the instructions in IKTKER.BWR and IKTKER.INS.  The only change
  60. in procedure for ROSCOE is to include the ROSCOE-specific updates in the
  61. KRMUPD step.  This can be done quite easily by concatenating these
  62. updates to the SYSIN DD declaration as a second data set for input.  It
  63. is expected that TSO Kermit will undergo upgrades from time to time
  64. without necessitating any change to the ROSCOE-specific information in
  65. this file and IKRKER.UPD.  You should therefore keep track of new
  66. developments under both IKT and IKR.
  67.  
  68. ---------------- 91/1/3 --- DS -----------------------------------------
  69. To run properly in a ROSCOE environment, Kermit must be defined in the
  70. ETSO EPL (eligible program list):
  71.  
  72. KERMIT   3000 1024 1024 D   CP                   KERMIT PROGRAM
  73.  
  74. These numbers (CPU time slices and memory allocation limits) can be
  75. increased or decreased as sites see fit.  The column position of the
  76. numbers is important for entries in the EPL.  Also, Kermit has to be in
  77. a ROSCOE ETSOPGMS DD concatenation.
  78.  
  79. ------------------------------------------------------------------------
  80. B) Unresolved problems/warnings ........................................
  81.  
  82. Refer to IKTKER.BWR first for such messages.
  83.  
  84. ---------------- 88/10/20 --- JL ---------------------------------------
  85. TSO Kermit running under ROSCOE/ETSO seems to work for us until we do a
  86. micro-MVS transfer without specifying a receive file name, whereupon
  87. ROSCOE dies.  There are problems in trying to create a host data set
  88. name that violates ACF2's rule.
  89.  
  90. ---------------- 91/1/3 --- DS -----------------------------------------
  91. The major limitation is the need to use only MVS files.  There is no
  92. support for ROSCOE library members.
  93.  
  94. ---------------- 91/1/11 -----------------------------------------------
  95. The MVS "userid" of any ROSCOE address space, and, thus, the PREFIX
  96. initially used by Kermit is "ROSCOE"; it is not your ROSCOE library
  97. prefix.  Be careful, since having an invalid prefix for MVS disk I/O can
  98. lead to disaster.  For example, the Kermit DEBUG subcommand would use
  99. the dataset ROSCOE.KER.LOG by default, no matter how many Kermit users
  100. there may be at one time.  It is a good idea to reset the PREFIX used in
  101. Kermit to something else.  Also, it may be necessary to SET FILE UNIT to
  102. an appropriate group name.  Note, however, that the means of typeout
  103. interception always uses the dataset ROSCOE.KER.BUF, regardless of the
  104. current Kermit PREFIX -- that is one reason why host commands are
  105. disabled in ROSCOE Kermit.
  106.  
  107. ---------------- 91/01/11 ----------------------------------------------
  108. Regarding the problems with system commands (see below in part D), there
  109. is some question whether *all* commands would cause the ROSCOE address
  110. space to crach, but there is certainly a problem with "OPER".  Further
  111. research is necessary to determine whether it would be worthwhile to
  112. allow a specific list of commands to be executed.  Any contributions of
  113. information on this topic will be welcome.
  114.  
  115. ---------------- 91/2/7 --- SC -----------------------------------------
  116. ROSCOE Kermit sometimes stops communicating properly with the micro.  If
  117. STOP doesn't help, and the host is accepting input, then pressing CLEAR
  118. several times gets a "terminal I/O error", and Kermit is back in
  119. control.
  120.  
  121. ---------------- 91/2/7 --- SC -----------------------------------------
  122. ROSCOE has an escape character that defaults to "..".  Set this to
  123. something else if you expect double periods in input from the remote
  124. Kermit.
  125.  
  126. ---------------- 91/3/29 -----------------------------------------------
  127. ROSCOE Kermit has been tested only in fullscreen mode (i.e., through a
  128. 7171).  There is no reason to suppose, however, that it would not work
  129. in line mode.
  130.  
  131. ------------------------------------------------------------------------
  132. C) Problems with workarounds or optional fixes .........................
  133.  
  134. ---------------- 90/8/10 -----------------------------------------------
  135. On a system without TSO/E, the STFSMODE macro doesn't allow the
  136. specification of NOEDIT=YES, which Kermit uses.  However, if you don't
  137. run VTAM, the STFSMODE macro isn't needed at all.  Also, without TSO/E,
  138. the TPUT macro won't have a NOEDIT option, and the NOEDIT=YES option in
  139. STFSMODE is superfluous anyway.  The following update should do the
  140. trick:
  141.  
  142.  ./ R 05821200          $ 5821200 40                   08/10/90 19:54:15
  143.           STFSMODE ON,INITIAL=YES Full-screen mode
  144.  ./ D 05846800                                         08/10/90 19:49:30
  145.  ./ R 05849400 05849600 $ 5849500 200                  08/10/90 19:49:30
  146.           LM    0,1,0(8)      Load up registers for SVC
  147.  
  148. Also, you may need to issue the Kermit subcommand SET SEND PARITY MARK
  149. before attempting transfers.
  150.  
  151. ---------------- 91/1/3 --- DS -----------------------------------------
  152. Occasionally, when Kermit is initially called in ROSCOE, the call will
  153. fail with a message complaining of an illegal MODESET SVC 107.  However,
  154. no adverse effects seem to come from this, so we trap this message in an
  155. RPF in this manner:
  156.  
  157. TRAP
  158. CALL KERMIT
  159. IF S.TC EQ 99 THEN
  160.    CALL KERMIT
  161. ENDIF
  162.  
  163. We've never seen it fail twice in a row.
  164.  
  165. ------------------------------------------------------------------------
  166. D) Resolved problems ...................................................
  167.  
  168. ---------------- 91/1/3 --- DS -----------------------------------------
  169. Certain "HOST" and "TSO" subcommands could cause the entire ROSCOE
  170. address space to crash with an S0F9 ABEND.  The TSO "HELP" command also
  171. wouldn't function correctly.  The draconian solution is to disable all
  172. these subcommands so that users can not issue them.  The fix: VS91003 in
  173. IKRKER.UPD.
  174.  
  175. ---------------- 91/01/04 ----------------------------------------------
  176. Kermit would operate normally when only one user at a time was running
  177. it, but a second user would trigger an ABEND.  This was due to Kermit's
  178. subtask for timing out in linemode.  ROSCOE Kermit no longer does that.
  179. The fix: SC91004 in IKRKER.UPD.
  180.  
  181. ---------------- 92/01/10 ----------------------------------------------
  182. ROSCOE Kermit is in the midst of an enhancement effort designed to add
  183. support for the ROSCOE AWS and library members.  It so happens that
  184. Kermit can already upload to the AWS under the guise of a dataset named
  185. 'ROAWS'.  The other functions are requiring extensive code modifications
  186. (volunteer testers welcome!)
  187.  
  188. ------------------------------------------------------------------------
  189.